# Replication package (Social Science & Medicine submission)

This package reproduces the key analysis outputs used in the manuscript:
**Information Freedom and the Gap Between Reported COVID-19 Deaths and Excess Mortality:
Cross-national Evidence**.

## What is included
- `data/owid/owid-covid-data.csv`: OWID COVID dataset snapshot used for replication.
- `data/vdem/vdem.RData`: V-Dem dataset snapshot used for replication.
- `data/worldbank/worldbank_baseline_2019.csv`: World Bank baseline snapshot (offline fallback).
- `scripts/`: deterministic scripts to build derived datasets, run models/robustness, and generate figures.
- `requirements.txt`: Python dependencies used to generate outputs in this package.

## What is intentionally NOT included
- Any title page / author contact details / acknowledgements.
- Any unrelated datasets from the larger project workspace.

## System requirements
- Windows / macOS / Linux
- Python 3.10+ (tested with Python 3.13)

## Quick start
From the package root:

```bash
python -m venv .venv
```

Windows PowerShell:
```powershell
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
python run_all.py
```

macOS/Linux:
```bash
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt
python run_all.py
```

## Outputs
Generated outputs are written to:
- `outputs/data/` (derived datasets)
- `outputs/tables/` (main/robustness tables)
- `outputs/figures/` (diagnostic figures)
- `submission_like/figures/fig1_panels.png`, `submission_like/figures/fig2_panels.png` (submission-style multi-panel figures)

## Data sources / citations
- Our World in Data COVID-19 dataset (OWID): https://github.com/owid/covid-19-data
- V-Dem dataset: https://www.v-dem.net/
- World Bank WDI + Worldwide Governance Indicators (via API): https://api.worldbank.org/

See `MANIFEST_SHA256.txt` for file checksums of this package snapshot.
